Knob Tool - Dynamic Configuration of ActiveX Properties

The [ActiveX] property on the Normal page provides a method for dynamic configuration of some of this tool's ActiveX properties (ActiveX page). This may be desirable in a templated environment where you want the configuration of the object to reflect the individual facilities.

For example, the PositionMin and PositionMax property values can be set to 0 and 100 on the ActiveX page. This static scale will be shown regardless of the facility for which the screen is showing data. Or, using the [ActiveX] property, values can be based on the Minimum Setpoint and Maximum Setpoint properties in the point configuration record of the object’s primary point. If the point configuration record contains setpoints of 50 and 250, the scale will show as 50 to 250. If the setpoints are 0 to 100, the scale will show as 0 to 100.

The table below lists the ActiveX Properties that can be dynamically configured, possible sources for the value, the properties of the source that can be applied, and where the property of the source is stored.

ActiveX Property Description Source Source Property (Display Item) Property Storage Location

CurrentMax

Specifies the maximum value reached by the Position property. It is reset each time the Position value is greater than the CurrentMax value. The only way to access the value is programmatically (i.e., using script).

Any point

Value

Real-time record.

CurrentMin

Specifies the minimum value reached by the Position property. It is reset each time the Position value is less than the CurrentMin value. The only way to access the value is programmatically (i.e., using script).

Any point

Value

Real-time record

PositionMax

Specifies the upper limit of the indicator level. Default is 100.

Any point

Maximum Setpoint

Value

Point configuration record (Analog page)

Real-time record

PositionMin

Specifies the lower limit of the indicator level. Default is 0.

Any point

Minimum Setpoint

Value

Point configuration record (Analog page)

Real-time record

The CurrentMax, CurrentMin, PositionMax, and PositionMin can be based on properties of the object’s primary point or any point in your CygNet domain. If a point identifier is not specified, the primary point is used.

To Set Up Dynamic Configuration of ActiveX Properties

  1. Show the Property Sheet for the object.
  2. On the Normal page of the object’s Property Sheet, double-click [ActiveX] property to show the ActiveX Property Configurations box.
  3. Add an ActiveX property to the ActiveX Property box:
  1. Click the Add button.
  2. Select one or more properties from the list and click OK.
  1. Configure each property in the list:
  1. Click on the property in the ActiveX Property box.
  2. In the Display Item box, select the item on which to base the value of the ActiveX property. If you are configuring a SectionColor property, indicate the desired Color Mode.
  3. In the CygNet Tag section, select the identifier of the point from which the value will be obtained. Leave the fields blank to use the object’s primary point.
  1. Click OK.